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AN ENGINE 
FOR LITTLE 
GAMES, 
WORLDS, 
AND STORIES 


hi! 


bitsy is a Little editor for 
Little games or worlds. the goal 
is to make it easy to make games 
where you can walk around and 
talk to people and be somewhere. 


have fun making things with 
bitsy! 
- adam 
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Bitsy wos born in the lote 
summer of 2016 ой O commuter 
shuttle bus from Seattle to 
Microsoft's Redmond campus 
... Adam Le Doux, the creator 
ofthe qame-makingsoftwore, 
wos working os O programmer 
ot Microsoft. 


While sitting on the bus, he 
would type the “gome data” 
(grids of letters und numbers 
representing the sprites and 
rooms, plus text for dialogue) 
Into the notes app on his 
phone. These notes were 
synced to Dropbox, 


ond e makeshift version of 
Bitsy read the Dropbox text 
files. This iteration of Bitsy 
then displayed the дате on 
his personal website, so that 
while Le Doux wos writing the 
text file on his phone, he could 
ploytest the gome. 


The impact was immediate. 
“This tiny little thing 
unlocked some creativity,” 
he says. 
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When you first open Bitsy, you will see а selection of ‘tools’ open 

in the workspace. Above this is the toolbar which allows you to open 
and close these Bitsy tools. If you can’t see the toolbar, click on 
the ‘tools’ button in the top-right of the screen. At the top of the 
workspace you can edit the title of your game, which will display when 
the game first begins. 


Bitsy games аге composed of several rooms that your avatar can walk 
between. As your avatar walks around your Bitsy world they may 
interact with sprites (people, objects etc. that you can talk to) and 
items. Anything non-interactive in a room is called a tile, which is 
used for decoration. In Bitsy you create your sprites, items, tiles, 
and behaviour such as dialog and transitions between rooms in 
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different tools from the 
toolbar, and then put them all 
together inside the room tool. 
The room tool is also where 
you can play the game you are 
creating, making it easy to 
switch back and forth between 
editing and testing. 


At any point you can download 
your game to play it outside of 
the Bitsy editor. 
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avatar to walk between them. 


Rooms are always composed of 


16x16 tiles, but what is in 


ПЕН 

- A ‘room’ іп Bitsy is where the 

[=] action takes place! Rooms are 
where your avatar walks around 

- and talks to others. 

a You may have as many rooms as 

a you would like and can connect 

п them together using the exits 

B & endings tool, allowing your 

а 
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each of those tiles is up to 
you. 


There are several room editing 
rools and room settings 
available at the bottom of 

the room tool that allow you 
to change the appearance, 
behaviour and audio of each 
room. 
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Тһе ‘room tools’ tab underneath have а few useful navigation and view 
tools here which are worth exploring. The ‘grid’ button toggles the 
tile grid on and off, which can make it easier to see what’s going on 
in the room. The ‘walls’ button shows you a mask of all the tiles that 
are marked as 'wall', which is really handy for quickly checking your 
collision zones. In the ‘paint’ tool you can also duplicate and delete 
tiles, and add animations. 
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Тһе tiles in the room work in 
the same way as editing pixels 
in the paint tool — click ona 
tile to remove it, then click 
again to place the one that you 
currently have selected in the 
‘find drawing’ panel. 


Bm To make a new room, either use 


Se the + button, or the duplicate 
ES 
иш 


button next to it if you 

want to preserve your tile 
placements. A new room appears 
and you can now move back and 
forth between rooms using the 
arrow buttons. 


Try making and placing a few 
different tile types in your 
room! 
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Тһе paint tool is where you can 
create and edit all the objects 
in your game, such as people to 
interact with, items to pick 

up, and background decorations. 
Att drawings can be edited and 
animated, and each category of 
drawing has additional behaviour. 


To edit any drawing, click the 
pixels in the main paint canvas 
to toggle them on or off. ALL 
drawings use the ‘background 
color’ set up in the colors tool 
as the background color. Then, 
tiles use the ‘tiles color’, 

and avatars, sprites, and items 
use the ‘sprite color’ as the 
foreground. 
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playing the game. Because Bitsy 
games are single player there is 
only one avatar in the game. How- 
ever, you сап optionally choose to 
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Tiles are used to decorate your 
rooms. You can create as many 
tiles as you Like, and for each 
one you can place as many as you 
Like in your rooms. Tiles can be 
set as ‘watt’, which means that 
the avatar is unable to walk 
through them. 


sprite 


Sprites аге реорїе ог objects in 
your game that you can talk to. 
You can give them dialo that 
plays out when the avatar walks 
up to them. You can also assign a 


_ ven you can only have one version - 


of each sprite in the game. 
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Every room іп Bitsy has а color background color: anything 


palette containing three colours, that is not interactive, the 
which all the artwork in the background color of all tiles 
room will use. You may have as and sprites 

many palettes as you Like, and 

can assign апу one of these to tile colon: the foreground color 
each room in the room settings. of all your tiles 

The three colors in the palette sprite color: the foreground 
are: color of your avatar, sprites, 


and items 


ALL the drawings you create can 
be found by navigating through 
the tabs and arrow buttons at the 
top of the tool, but you can also 
access them from the find tool. 
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> The dialog tool is опе of Bitsy’s most powerful tools. It is used 
to create all the interactions the player has within the game. 


> For example, the most basic use of the dialog tool is to create 
text that will be displayed when the player walks into a sprite, 
e.g. the cat saying “I’m a cat”. 


> At a more complex Level it can be used for things Like branching 
dialog with choices based on the number of items the player has 
picked up, or, unlocking a door if the player has spoken to a 
specific sprite. 


> Dialog can be assigned to sprites, items, exits and endings. 


Е- playing... 
> Text effects change the way 5 
text Looks in game: 


example room 
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{муу} wavy folmat {/wvy} 


{shk} shaky format {/shk} 
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> There are other dialog example 
features which can create 


who are you? 
more complex systems. Е 
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> Conditional boxes only cycle list 

e e repeat items in a cycle: 
bring up a text box if 1) 
conditions have been met. 


> Lists will bring up a 
sequence of text boxes. The 


sequence can show once, 
be repeated, or randomly 
displayed. 
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» Room actions can change 
things that happen in said 
room — such as adding exits 
& endings, morphing sprites, 
locking doors, etc. 


» Furthermore, you can edit 
item interactions through 
item and variable actions. 


> You can increase, decrease, 
or set the number of items in 
an inventory. 


> You can also introduce 
variables, an advanced 
function of Bitsy. 


> Variables аге a piece of data your game сап store and use to 
perform Logical operations. Basically, if you want your Bitsy 
project to be less story (a linear narrative all players will 
encounter in the same way) and more game (a scenario where player 
choices affect what occurs), you’re going to need to use variables. 


> Variables can be set from inside dialog using curly braces and 


the equals sign. Curly braces ‘{}’ in Bitsy dialog represent a 

‘code block.’ Meaning that Bitsy knows that when it encounters an 
open curly brace, that means that everything between that and the 
corresponding close curly brace are code it needs to process, rather 
than simply text it needs to display. 


This signature is а mash up of There's text below it that says 
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EXCERPTS FROM Babycastles and 
Parsons School of Design’s GAME 
ENGINES BEYOND GAMES symposium 
on September Sth, 2020 


transcript and talk by 
Em Reed 


А description of medium and process is often 
included in the wall label or discussion 
of an art work, but this information can 
be hidden, sometimes deliberately in 
videogames. With a few exceptions, we talk 
about videogames as if they are made up of 
the same "stuff." This is partly because 
the professionalization of the industry 
has tried to make process invisible, and 
present the videogame as a slick, black- 
boxed toy. 


When new tools for game-making become 
accessible outside of this, what people make 
can be quite different from professional 
game development. Elements of the process 
are often more visible. 


“Indie games” only became possible through 


there being more tools and opportunities 
to make and distribute videogames; people 
had always been doing their own hobbyist 
or amateur programming. The emergence of 
“indie” as a classification was not something 
outside of corporate centralization, but 
working alongside it. 


This connects to language like “democra- 
tization” and “supporting the indie com- 
munity” tools promote themselves with, or 
how storefronts discuss independent titles. 
How democratic are the things these tools 
and platforms actually do? Funding a few 
projects selected to be featured on their 
closed or rent-seeking platform? Becoming 
an industry standard or ubiquitous enough 
that they are what everyone is ushered to- 
wards? These are capitalist-oriented views 


of “community” which indicate captive 
users to extract value from, in the form of 
rents, royalties, content, or demographic 
info, rather than people choosing to work 
together, for collective benefit. 


We become entrenched іп а capitalist 
scarcity mindset when we get protective over 
who really makes games, what games really 
look Like, what tools make real games. From 
that perspective, the best we can hope 
for is that the “right” games, whatever 
that means, get the publisher deals and 
privileged placement on storefronts. I’d 
rather see it as a huge opportunity that 
there are so many games and so many ways of 
making them. We have to rise to meet the 
шаув people are relating to videogames and 
using game tools to stay relevant. 


To call tools that embody this attitude 
“accessible” or “easy” or “indie” homogenizes 
them. Instead I call them “mass art” tools. 
I use “mass art” not to describe work that 
is made and distributed at scale, or popular 
(or well-advertised), but in the sense that 
Susan Sontag uses it. She observed that in 
the 1970s, photography “has become almost 
as widely practised an amusement as sex and 
dancing-which means that, like every mass 
art form, photography is not practiced by 
most people as an art.” 


Mass game making would mean many people 
using these tools aren't using them as 
а game developer or member of the game 
industry, even aspirationally. It may seem 
utopian given the squeeze on arts funding 
in general and the power of for-profit 


platforms in gaming but I think we have to 
consider this type of production worthy and 
exciting in itself, not as a pool to pick 
out sleeper hits or game design students 
from. 
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Bitsy is а game engine that does а lot of 
these things, and interests me a 10%. Bitsy 
started out as a way to work on games with 
a notes app while on the bus home from work. 
There's пом an online javascript-based 
interface which outputs text files, which 
work the same way as this early text-only 
development, and HTML files where the game 
is interpreted and run in-browser. 


Bitsy references older formats and the 


qualities of digital media itself. The 
pixels in each 8x8 tile are defined as 
binary 05 and 1s, and items you can interact 
with are a different color than static 
tiles, giving each 8x8 tile room a three 
color palette. This may seem restrictive or 
destined to always "look like Bitsy” from a 
professionalized game design perspective. 


In practice, however, there are over 2000 
Bitsy games posted to Itch.io. This has led 
to a culture that is self-directed, which 
shares and pools resources and builds on 
others’ work, and is not doing this in the 
context of a proprietary modding or user 
generated content context. Bitsy provides 
an intuitive interface that produces 
Lightweight and legible files that have 
existing distribution channels, under a 


creative commons Licence so making things 
Like mods and hacks are both technologically 
straightforward and explicitly condoned. 
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Bitsy collections have been included іп 
several game festivals and exhibitions, with 
custom hardware Like the Bitsy Boutique, or 
with tools that allow multiple games to be 
presented in the same Bitsy page. Because 
Bitsy games are text or html files, they’re 
easy for existing archival organizations 
like the British Library to incorporate 
into their interactive fiction collections. 


Transparent game data means writing directly 
to the game data or creating tools that 


automate these hacks is a common way to add 
capabilities not included in the editor. 
Making and sharing hacks is a common way 
Bitsy developers help each other and work 
together on projects. Borksy is an example 
of a tool which automates adding several 
different hacks to any project. 


This leads to the formal development of 
the engine building on accessibility rather 
than complexity. Bitsy is available in 17 
languages, but has retained its original 
look and workflow, and hasn’t expanded 
features in a way that makes user developed 
hacks redundant. This prioritizes changes 
that allow more people to use Bitsy while 
still maintaining its legible interface. 
It also makes the development of the engine 
more distributed than hierarchical. 


Тһе games industry cares about videogames 
being called art, and I think artists and 
independent practitioners do too. It’s still 
hard and awkward to talk about videogames as 
art, because we’ve inherited so many anti- 
art assumptions of the tech industry. Often 
discussions revolve around a particular 
idea of how to make videogames, or what the 
proper uses of the medium are at the time. 


It may involve work that doesn’t seem Like 
videogames, or worse, seem like bad games, 
but considering this work can help shift the 
discussion around games towards one that 
values process and variety. It has already 
been said many times, but worries about 
accessible tools and storefronts leading to 
“too many games" аге overblown. 


It should be equally as ridiculous as 
saying there is "too much art" because so 
many people can pick up a digital camera 
or a pencil and paper. 
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i BYE ALDI TORE СЛ ше eater n Gera rooms • ® edit room from dialog: modify the content of a room from dialog 


+ ГЕ backdrops: makes the game have a backdrop • $ end-from-dialog: trigger an ending from dialog, including narration text (deprecated) 


i ЯЛ "ак" 
ЕЕ suae * Е exit-from-dialog: exit to another room from dialog, including conditionals 


Aaa pal ае handen * ¥ external-game-data: separate Bitsy game data from your (modded) HTML for easier development 


+ 4 canvas replacement: WebGLazy bitsy integration (this one's mostly just for me) 


» (2 favicon-from-sprite: generate a browser favicon (tab icon) from a Bitsy sprite, including animation! 


• & character portraits: high quality anime jpegs (or pngs i guess) К 
* y” follower: make sprites follow the player 
• # character portraits animated: high quality anime gifs ч 
7 " + ff gamepad input: HTML5 gamepad support 
» Q close on ending: Prevents from playing past an ending 


. % ity: ы i i i 
• 55 corrupt: corrupts gamedata at runtime ACTER feudo SETI rods tpe 


+ # custom-exit-effects: make custom exit transition effects сыншы Es Waa sys S smell aeu 


+ E custom text effect: make {custom}text effects(custom) • = javascript dialog: execute arbitrary javascript from dialog 


e ¢ dialog audio: animal crossing-style audio * Ed logic-operators-extended: adds conditional logic operators 


+ «* dialog audio vocal synth: animal crossing-style audio powered by the pink trombone vocal synth + H long dialog: put more words onscreen 

« Û dialog box transition: adds an easing transition animation to display the dialog box text + [3 multi-sprite avatar: make the player big 

* @ dialog choices: dialog choices * online: multiplayer bitsy 

• Я dialog jump: jump from one dialog entry to another e Ml opaque tiles: tiles which hide the player 

• ¢: dialog pause: add pauses in between printing text • — paragraph-break: Adds paragraph breaks to the dialogue parser 

• = dialog prompt: prompt the user for text input in dialog + Т permanent items: prevent some items from being picked up 

• ө directional avatar: flips the player's sprite based on directional movement * Ө push sprites: sokoban-style sprite pushing 

» 4, direction in dialog: provides a variable with player direction e FJ replace drawing: add name-tags to replace drawings when the game is loading 
+ [3 dynamic background: HTML background matching bitsy background e В save: save/load your game 

+ 7 edit dialog from dialog: edit dialog from dialog (yes really) * Q) solid items: treat some items like sprites that can be placed multiple times 


+ // edit image from dialog: edit sprites, items, and tiles from dialog + © stopwatch: time player actions 


+ ik edit player from dialog: change which sprite is controlled by the player + Ф: text-to-speech: text-to-speech for bitsy dialog 
» Medi [ 8 i It ES 
%® edit room from dialog: modify the content of a room from dialog ит. EEA ti e ees 7) 
хє 010000 Е 3 А 3 а 
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• ® favicon-from-sprite: generate a browser favicon (tal. icon) from a Bitsy sprite, including animation! 


o ER ites: i 
оаа ее teste RO EYES transparent sprites: makes all sprites have transparent backgrounds (deprecated) 


o Xie E EMS Е таа ана • 2% twine bitsy comms: interprocess communication for twine and bitsy 
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Hacks are additional javascript 
or code built by the community 
to add extra functionality to 
Bitsy. 


Tools are also developed by the 
community to help make Bitsy 
games. This includes making 

3D games, turning photos into 
rooms, creating color palettes, 
and a multitude of other 
things! 
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The most accessible way of 
adding hacks is through 
Borksy Fl. Developed by 
AYolland, Borksy gets the 
original gamedata from Bitsy 
and combines it with a 
template to create a modified 
file that contains the chosen 
hacks. 


Kitsy and Bitsy Bundler are 
other tools that are used to 
help hacks cooperate with 
each other. 
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Тһе current list of available hacks include: 


4 avatar by room (by Sean LeBlanc) 

+ backdrops (by Cephalopodunk & Sean LeBlanc) 
+ basic sfx (by Sean LeBlanc) 

-+ bitsymuse (by David Mowatt) 

+ Canvas replacement (by Sean LeBlanc) 

+ character portraits animated (by SeanLeBlanc) 
+ character portraits (by Sean LeBlanc) 

4 close on ending (by Sean LeBlanc) 

-+ corrupt (by Sean LeBlanc) 

4 custom-exit-effects (by Sean LeBlanc) 

+ custom-keyhandlers (by Sean LeBlanc) 

-+ custom text effect (by Sean LeBlanc) 


+ custom 
+ dialog 
& dialog 
& dialog 
& dialog 


+ dialog 


+ dialog 
& dialog 


text effect (by Sean LeBlanc) 

audio vocal synth (by Sean LeBlanc) 
audio (by Sean LeBlanc) 

box transition (by Delacannon) 
choices (by Sean LeBlanc) 

jump (by Sean LeBlanc) 

pause (by Sean LeBlanc) 

prompt (by Sean LeBlanc) 


& direction in dialog (by Sean LeBlanc) 
$ directional avatar (by Sean LeBlanc) 
4 dynamic background (by Sean LeBlanc) 
+ edit dialog from dialog (by Sean LeBlanc) 
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& edit image from dialog (by Sean LeBlanc) 
+ edit player from dialog (by Sean LeBlanc) 
4 edit room from dialog (by Dana Holdampf) 
+ end-from-dialog (by @mildmojo) 

4 exit-from-dialog (by @mildmojo) 

+ external-game-data (by @mildmojo) 

4 favicon-from-sprite (by @mildmojo) 

+ follower (by Sean LeBlanc) 

%- gamepad input (by Sean LeBlanc) 

4 gravity (by Cole Sea) 

+ itsy-bitsy (by Sean LeBlanc) 

+ javascript dialog (by Sean LeBlanc) 

+ Logic-operators-extended (by @mildmojo) 
+ long dialog (by Sean LeBlanc) 


+ multi-sprite avatar (by Sean LeBlanc) 

& noclip (by Sean LeBlanc) 

& online (by Sean LeBlanc) 

. opaque tiles (by Sean LeBlanc) 

& paragraph-break (by Sean LeBlanc, David 


Mowatt) 


& permanent items (by Sean LeBlanc) 

+ (9file utils utils (by Sean LeBlanc) 
¿+ replace drawing (by Elkie Nova) 

+ save (by Sean LeBlanc) 

& smooth moves (by Sean LeBlanc) 


& solid items (by Sean LeBlanc) 


+ sprite effects (by Sean LeBlanc) 
++ stopwatch (by Lenny Magner) 
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+ text-to-speech (by Sean LeBlanc) 

+ tracery processing (by Sean LeBlanc) 

+ transitions (by Sean LeBlanc) 

+ transparent background (by Cephalopodunk & 
Sean LeBlanc) 

* transparent dialog (by Sean LeBlanc) 

+ transparent sprites (by Sean LeBlanc) 

+ twine bitsy comms (by Sean LeBlanc) 

+ unique items (by Sean LeBlanc) 
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Additionally, Borksy features: 


+ Multiple Bitsy version templates 

+ Preloaded Hacks Menu 

+ Editable hack options 

+ Customize HTML/CSS 

+ Customize page title / filename 

+ Field for extra JS / hacks 

+ Saves work to LocalStorage for 
persistence 

4 Updated default Bitsy font with 
more consistent unicode support 

+ Party Mode! 
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One of the most radical Bitsy 
hacks/tools is Bitsy 3D М, 
developed by (9aloelazoe, which 
allows users to create a 3D 
game following the typical 
Bitsy 'aesthetic'. This type of 
tool is also called a fork - a 
tool that splits off from the 


original engine. 


The hack builds off of the 
existing Bitsy editor tools 
— with one extra tool, the 3D 
scene! 


2х 
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КЫ description 2х 


Other transformative Bitsy forks 
include Bitsy Color + and 
Bitsy НОЯ. 


Bitsy Color + allows a full range 
of how ever many colors added 

to the palette. This, of course, 
allows more than the typical 
three colors provided by Bitsy. 


Bitsy HD uses a 16 x 16 pixel 
grid for sprites and tiles, 
allowing detailed visuals. 


КЫ description эх 


Many Bitsy tools feature the 
ability to turn external 
assets, Like digital images or 
sprite sheets, into Bitsy rooms 


or sprites - such as: 


E + pixsy (images -> rooms) 

5 + RGBitsy (color images -> rooms) 
-RGBsprite (images — sprites) 
-Spritesy (import sprites) 
-tilesy (import tiles) 


Ж. de 


Se 


previous add room 


Paste palette data here. 
(ignores sprite color) 


show grid 


ш 
тоот: 24 
saturation: 57 


lightness: 0 
Bitsy O BitsyHD 
use dithering Canvas 
Click colors to lock, double-click to pick. 
7 HEN CH алин 
ш : 
00000000 
01110100 
00001000 
00110111 
00011101 
00011100 
тый 00010100 
clustering 


by color О by channel 


max tiles: 126 


КЫ description Ё Ll description 2х 


Audio is ап important part Other tools that help stream- 
of Bitsy games. The В11р-0”- Line Bitsy game development 
Matic tool within Bitsy is include: 

the primary way to create 


audio, but many tools/hacks + Fontsy (font editor) 


add additional features. Tools * BitsyTTF (font editor) 
that aid song creation ог audio * Palettesy (palette creator) 


development include: * Bitsy Merge (merge games) 

* Mixsy (merge games) 

+ Bitsy Savior (save game data) 
* bitsy optimizer (optimize data) 
* Bitsy Museum Hack (link games) 
+ Flipsy (flips rooms) 

+ Shiftsy (shift rooms) 


+ bitsy vocal synth tester 
(sprite voices) 

+ bitsy audio (background noise) 

+ bitsymuse (+ music functions) 


E y Ч m 
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bitsy vocal synth tester 


Inputs 


tool for interactively testing the dialog audio vocal synth hack 


text 
volume 

pitch 

vibrato 
phoneme 
nasal 

voiced 
tonguePosition 
tongueSize 


tongueAmount 


I'ma cat 
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Preview 


SHIFTSY - The Bitsy Room Shifter 


Shiftsy allows you to quickly shift Bitsy room data! Pan left, right, up, or down any number of tiles! Shift the 
same data multiple times to create a scrolling effect! - does not include exits, sprites, or the avatar in shifted data - 


INPUT OUTPUT 


paste your room data here copy your new data here 


shift data which direction? 
left a 


shift data how many tiles? 
1 


fill new tiles with tile id... 
0” for по fill tile. ignored if ‘wrap tiles’ is checked. 
0 


wrap tiles? (| 
shift data 


about the author 


КЫ description 2х КЫ description эх 


Emulators аге programs that Bitsy is an open-source tool 
simulate other devices. Bitsy that’s free for anyone to 

is primarily a browser engine access, allowing the growth of 
that runs on Javascript and " community. Similar programs 
HTML, but with emulators, Bitsy have been created based off of 
games can be played on a multi- Bitsy that follow its aesthetic 
tude of different platforms. and philosophy, such as: 


*bipsi Y 


Emulators developed for Bitsy + binksi Y 
* binksi М 


include: 

+ bitsybox 
*Bitsy Converter 
+Bitsy Boutique 
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Come...come my child, 


who summoned УСМ ... 


bitsy 


a little engine for little games, worlds, and stories - By adam le doux 


Tool Community Devlog 


Community Search community 


Recent updates 


v8.12 - bugfixes, docs, 20 5% no dialogue jam has Бе 
update to blip tool О 10 days ago 
© 5days ago | forgot to make a post earlier, 


dialogue" #bitsyjam has starte 
week to make a submission sa 


it's time for another bitsy update! <3 in this 
version the blip tool gets a re-generate button 


courtesy of @nashalexander (so you don't have to time if you'd li... 


create a whole n... 


Ф 1file 8.12.0 


hi there! 


welcome to the bitsy forum, a friendly community for people who make and play bitsy games! we pos a 1 g i Il 
development, and hobbyist making in general. feel free to share your creations, recommend interesti i a r ng i 0 a 


before posting for the first time, please read the rules and introduce yourself! 


bitsy community >> bitsy >> tips & help 


hi there! 


A topic by adam le doux created Ф 1 minute ago Views: 0 Replies: 0 


welcome to the bitsy forum, a friendly community for people 
who make and play bitsy games! we post about making and 
playing bitsy games, small game development, and hobbyist 
making in general. feel free to share your creations, 


recommend interesting bitsy games, and ask Тог help using 
bitsy to make games. 


- adam 


bitsy community >> bitsy >> tips & help 


[2] what to expect: 


* friendly and patient people who will help and encourage you to make bitsy games 


* a majority of neurodiverse trans gay anti-capitalists. if you don't like this you 
are free to avoid any political discussion. 

+ slow but firm moderation. if a situation is blowing up, please contact the 

moderators and then disengage. 


what we are trying to be: 


+ a community Рог people interested in making and playing bitsy games. 

+ welcoming and respectful. racism, transphobia, ableism, homophobia, and sexism will 
not be tolerated. mistakes can be forgiven, but you must listen when others ask you 
to correct your behavior. 


bitsy community >> bitsy >> tips 6 help 


[2] what we are NOT trying to be: 


* a public space. if you are toxic to the community, you will be removed. 
+ a support service. all help is offered on a voluntary basis, do not demand it. 


also: 


+ trans rights are human rights 
+ black lives matter 
+ асай: defund the police 


bitsy community >> bitsy >> tips & help 


help! where do i go to access bitsy and its community? 


A topic by miencha created & 1 minute ago Views: 0 Replies: 0 


m Bitsy Editor can be accessed here: bitsy.org ! Bitsy games, 
forums, and tools are available on itch.io. 


in the forums, you can introduce yourself, ask Тог tips, 
showcase your games, and keep up with what's happening in the 
community! you can also access the devlog, and see what's being 
worked on ог added to the engine! 


bitsy community >> bitsy >> tips & help 


how can i get started making Bitsy games!? i don’t know how to code! 


A topic by miencha created & 1 minute ago Views: 0 Replies: 0 


№ 


Bitsy is built to be accessible! Bitsy Editor works in your 
browser, ав well as all Bitsy games. You don’t need to now 
any code to get started, and there are plenty of tutorials 
to help, as well as an entire community to turn to for 
questions! You can certainly embellish features using code 
(Javascript), but for the most part it’s unnecessary. 


bitsy community >> bitsy >> tips & help 


what’s a game jam? how can i join? 


A topic by miencha created & 1 minute ago Views: 0 Replies: 0 


№ 


А game jam is where you try to make а game from scratch, 
either by yourself or with a team. 


Bitsy game jams are themed and monthly. all you have to do is 
submit your game (given it was made within the timeframe) on 
the itch.io page. bitsy game jams aren't judged, and you're 

welcome to check out all the other games that were submitted. 


bitsy community >> bitsy >> tips & help 


ok, but how does bitsy ACTUALLY work? 


A topic by miencha created & 1 minute ago Views: 0 Replies: 0 


m Bitsy Editor runs on Javascript, and therefore produces HTML5 
games. the tiles are represented by binary and true/false 
statements indicating whether they appear or not. 


Bitsy intentionally uses conditional variables rather than 
scripting. it gives users who are inexperienced in coding the 
chance to develop an interactive game. 


bitsy community >> bitsy >> tips & help 


№ 


Similarly, hacks and tools are also written with Javascript. 
Currently, the easiest way to build hacks is from seleb's 
Github hack repository. Tool and hack building does require 
Javascript knowledge. 


Bitsy and all of it’s hacks and tools are open source. Anyone 
can access Bitsy’s code through Github. Although it may have 
been started by one person, throughout the years, Bitsy’s had 
many contributors. It’s the product of a dedicated community 
of creators fueled by passion and Love of the craft. 


The те 
Solivagants |. 


(on Videogames Fait at 
Character Context) 


earth should I #begin#?" 


You give them а gentle tap on 


Bitsy strips away anything 
that’s not completely neces- 
sory to making an interactive 
Story... but those limitations 
meon you don’t have all this 
noise about what ОГТ style to 
use ог howto set up controls. 


The absence of them means 
that it’s easier to get to the 
core of the story, experience 
ог Message you're trying to 
convey. It’s why Bitsy gomes 
often feel so conceptually 
strong. 


After 


іо 


ысы close the 
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The engine has been 
featured at small-town 
libraries and coding events — 
spanning everywhere from 
Washington to England — as 
well as workshops ot the Uk" 
Notional videogame Museum. 


Bitsy Isnt just a stepping 
stone, and treating it as such 
risks legitimizing profession- 
ol work over that made using 
the editor. The beauty of Bit- 
sy 15 that it allows people to 
mole ort on their own terms. 


In these games, you con 
Sense the contours of lived 
experiences that inform 
them... It’s unclear how, if at 
oll, Bitsy will influence gomes 
іл the future. In o way, it 
doesn't reaily matter. 


БїК == legacy, on its own 
terms, іс dlready a gift. 


АМ EDITOR’S NOTE 
from miencha (michelle ding) 


i found bitsy a few years ago in 2021, my 
sophomore year of college. i discovered pixsy 
first while trying to find a image 4 pixel 
art site. at the time, i was commited to 
making pixel art — something about the poetic 
nature of the pixel (the building block of 
digital images, ог whatever,) had drawn me 
down a rabbit hole on the internet. easily, i 
could've downloaded aseprite and gone on with 
my day, but as а self-proclaimed ‘digital- 
space-media-artist’ i wanted something 
toothier — less illustrative, more realistic, 
more introspective. 


pixsy drew me in with it’s unique two-palette 
image conversion. fascinated, i eagerly 
started consuming Bitsy games, following 

the jams, lurking in the discord, until its 
eventual shutdown. 


i didn’t have the time to tinker with Bitsy 
that year, nor the next. in fact, it sat in 
the back of my mind for two years. i had 
long moved past my pixel art obsession and 
onto bigger and better concepts - analog 
machinery, the visual symmetry between wires 
and tree roots, the merging of nature and 
industry ... until, i got the opportunity in 
my graphic design class to create a book on 


anything i wanted. it took me a long time to 
settle on an idea. making a book would take 
quite a bit of research, time i wouldn’t 
necessarily have. what better reason, then, 
to capitalize on the knowledge i accumulated 
years ago on pixel art and digital spaces? it 
would go well with my portfolio of exploring 
digital + nature spaces, and in this case, i 
could showcase my print design abilities. 


gradually, i eased back into Bitsy and its 
intense archive of work on itch.io. it had 
been quite a while since my intense research 
bouts. 


inevitably, i was drawn іп completely. 
playing Bitsy games everyday, looking through 
devlogs, exploring Github repos. this book, 
which was planned to be 50 pages, grew to 
200. what was just an interest in Bitsy has 
grown to an attachment. 


after four years of art school, i’ve become 
quite jaded towards the art world. there is 
far too much value placed upon formal and 
aesthetic qualities. it’s difficult seeing 
the horizon as a visual artist when so much 
emphasis is placed upon exclusivity and 
merchandise. yet, against all odds, Bitsy has 
fostered a community where all of my 


all of my gripes are seemingly reversed. a 
deliberatly restricve engine that brings out 
the soul of stories, that nutures a burgeoning 
indie scene that champions creative, boundary- 
breaking art. there is something peculiar 
within Bitsy games that can only be described 
as a soul. with no room for polish, Bitsy 
forces authors and creators to bear their 
heart for all to see. 


in the past months i’ve spent cobbling this 
publication together, i have spent hours upon 
hours scouring Bitsy documentation оп itch.io. 
it’s not easy to find a community as dedicated 
and passionate as Bitsy’s. 


all of the information in this book is 
compiled by myself, but from existing 
sources. therefore, i would like to 
acknowledge: 


adam le doux, of course, sharing Bitsy; 
Claire Morwood, AYolland, Sean 5. LeBlanc, 
Em Reed, @vaasut, for creating 50 much 


documentation and tutorials; 


and everyone who’s contributed to Bitsy and 
making Bitsy games. 


ultimately, this book is not meant to be 
the complete guide to Bitsy. the engine is 
constantly changing, new tools and hacks are 


being developed as i write. Bitsy 
more complicated than what i have 
this small book — i urge everyone 
their own deep dive of this tiny, 
engine. the journey will be worth 


- miencha (michelle ding) 
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Іп the middle of the night 


text in this publication is pulled from: 


Bitsy Docs 
< make.bitsy.org/docs/ > 


Claire Morwood’s Bitsy Tutorial 
< www.shimmerwitch.space/bitsyTutorial.html > 


AYolland's Bitsy Variables: А Tutorial 
< ayolland.itch. io/trevor/devlog/29520/bitsy- 
variables-a-tutorial > 


seleb’s bitsy hacks Github repo 
< https: //github.com/seleb/bitsy-hacks > 


AYolland and Sean’s Borksy Game Hacker 
< https://ayolland.itch.io/borksy > 


Em Reed's Game Art Engines Talk 
< emreed.net/GameAnrtEngines Transcript > 


Wired's You Too Can Make These Fun Games (No 
Experience Necessary) 

< www.wired.com/story/you-make-fun-games-no- 
experience/ » 


Rock Paper Shotgun's How small game makers 
found their community with Bitsy 

< www.rockpapershotgun. com/how-small-game - 
makers-found-their-community-with-bitsy > 


The Verge’s Bitsy is the small video game 
engine with a big community 

< www. theverge. com/22929485/bitsy-tiny-video- 
game-engine > 


The Bitsy forum 
< ledoux.itch.io/bitsy/community > 


Jonas Johannason’s Bitsy Tutorial 
< www.exploring.technology/learn/bitsy > 


Bitsy games featured іп this publication 
include: 


Isa’s Pygmalion Lied 

< ars3n.itch.io/pygmalion-lied > 

Learning how to mourn is hard enough on its 
own. Rediscovering а long-dormant truth along 
the way makes it all the more complicated. 


Valeriy Petrov’s Museum of Everything 

< boticelly.itch.io/museum-of-everything > 
This museum is a work of fiction and thus 
doesn’t abide by the laws of space-time. 


Hyphinett’s Snowcrash 

< hyphinett.itch.io/snowcrash > 

It’s the middle of winter, your plane has 
crashed and you are one of two survivors. 
Search your surroundings for anything you can 
use to survive. 


Valeriy Petrov’s Where are you Kitty 

< boticelly.itch.io/where-are-you-kitty > 

Run away from the bombs into the mysterious 
cavern beneath the shelter. Made your way 
through the procedurally generated dungeon and 
met different people there. 


L'Osmose's M800KQ 

« losmose.itch.io/maggiore-800-losmose » 

M800KQ is a game about a lost guitar. It is 
loosely based on a true story. Released in 2024 
alongside our band’s first album, MAGGIORE 800. 


Hachimeki’s Lil Yuji’s Adventure 

< hachimeki.itch.io/lil-yujis-adventure > 

One day, Sukuna and Uraume discover an 
abandoned infant in their garden. Recognizing 
the potential of becoming Sukuna’s vessel, they 
raised him. 


raven’s static angels 
< raven7.itch.io/static-angels > 
a short poem-game about unwanted memories. 


AshG’s Midwinter Sprits 

< ashg.itch.io/midwinter-spirits > 

As the days grow shorter & dark nights 

seem endless, you abide by the old winter 
superstitions & folklore, & keep the village 
fires burning to welcome back your ancestral 
spirits. 


Gabriel Helfenstein’s The City has a Problem 
< gabriel-helfenstein.itch.io/the-city-has-a- 
problem > 

A short bitsy game about loneliness. 


Pol Clarissou’s Moss as Texture as Space 
Folding onto Itself 

< polclarissou.itch.io/moss-as-texture-as- 
space-folding-onto-itself> 


Nic’s The Spirits of Bluebirch Forest 

< chickenricetm.itch.io/the-spirits-of- 
bluebirch-forest > 

Autumn is here, the crops are ready, and you 
are an unexpected visitor at the McLaughlin 
Farm. A tiny game harvested from an appre- 
ciation of nature, and in anticipation of the 
coming season. 


Karina Popp’s the_right_song_now.mp3 

< knarniapop.itch.io/right-song > 

It’s 2007, you’re 16-years-old and you just 
revamped your profile page.Now all you need is 
the right song. 


onion’s a Day in the Life of a Sea Witch 

< le-onionboi.itch.io/sea-witch > 

there is a lack of bitsy mermaid games... so of 
course i had to make a game about a cecaelia 
that featured mermaids “"1_(“.w.')_/” 


zeno pillan’s I һауе а cool game оп my Nokia 

< zeno-pillan.itch. io/i-have-a-cool-game-on-my-nokia > 
A short adventure game made with bitsy for the 
Nokia 3310 JAM 6 


christine mi’s the mountain is as it always is 
< cxmi.itch.io/the-mountain > 

A small narrative game about mountains, 
emptiness, loss, and remembering what it means 
to be alive. 


communistsister & Grim Baccaris’s The End of Decay 
< https: //communistsister.itch.io/decay > 

in a quiet library on the World, a history book 
spills its sordid secrets 


cecile richard’s Under a Star Called the Sun 

< haraiva.itch.io/under-a-star-called-sun > 

a sci-fi bitsy game about grieving, holding on 
to fading memories, and carrying the world on 
your shoulders. 


michalsho’s Roam 

< michalsho.itch.io/roam > 

Just as the ability to fly disappears when it 
is not needed...so does migratory instincy 
when it has no purpose. 


Niandra!’s Museum of mid-2000’s forum signatures 
< niandra.itch.io/museum > 

Inside this humble museum dedicated to media 
left behind, you will find 15 pieces on 
display. 


IAN MARTIN’s CLINT IS NOT AN INCEL 

< ianmartin.itch.io/clint-is-not-an-incel > 
CLINT IS NOT АМ INCEL: A word оп fatness and 
masculinity 


dreamingamaris’s Insurgence 

< dreamingamaris.itch.io/insurgence > 

Those who obey MUTHER survive. Those who don’t 
are killed, or get their memory erased. 


ghostsnwitches’s Leaves in the Rain 

< ghostsnwitches.itch.io/leavesintherain > 

Have you ever noticed how leaves will flip over 
before it rains? 


thatsmaik’s Caste of the Water Monks 

< thatsmaik.itch.io/caste-of-the-water-monks > 
Talk with all the water monk ghosts on this 
little peaceful island. 


candle’s Forgotten Depths 
< candle.itch.io/depths > 


Fred Bednarski’s The House of the Living 

< vonbednar.itch.io/the-house-of-the-living > 
A gothic bitsy adventure. A sinister mansion 
calls to you, will you discover its secrets? 


Rowan Crawford’s The Solivagants 
< https: //sumaleth.itch.io/thesolivagants > 
A playful examination of Character Context. 


*Xact's Three Photographs of а Red Winged 
Blackbird 

< xact.itch.io/three-photographs-of-a-red- 
winged-blackbird > 

A short and sweet photo essay. 


PRINCESS INTERNET CAFé’s Sprout Solstice 

< princessinternetcafe.itch.io/sprout-solstice > 
It’s the day of the Winter Solstice! You’re 
normally super busy on this day, being a lil 
druid and all. However, your mentor has asked 
you to instead help the other villagers with 
the cooking for tonight’s feast. 


capnka’s i miss when the internet was 
chronological 

< https: //capnka.itch.io/i-miss-when-the- 
internet-was-chronological > 

a short bitsy game about holding on to deleted 
memories, the ephemeral nature of the digital 
landscape (апа tumblr’s golden era) 


zeno pillan’s Pickle 
< https://zeno-pillan.itch.io/pickles > 
Pickles is а micro-game about buying Pickles. 


Wandering Artist’s METROPOLIS 2123 

< https: //wandeer.itch.io/metropolis-2136 > 

In the city of Metropolis people live like 
machines in the lower level while rich 
corporations keep their domain in the upper 
level, thanks to their technology and a strict 
control on copyright laws. 


julian's Titan 

< feral-royal.itch.io/titan > 

a monthly jam entry about dirt and things inside 
of it. 


cephalopodunk's Junk Shop Telescope 

< cephalopodunk.itch.io/junk-shop-telescope > 
Oh hey, cool, I bought а second-hand telescope, 
let’s try it out... 


adam le doux’s When I Get Home 
< ledoux.itch.io/when-i-get-home > 


adam le doux’s September is Halfway Over 
< ledoux.itch.io/september-is-halfway-over > 


adam le doux’s In the Middle of the Night 
< ledoux.itch.io/in-the-middle-of-the-night > 


First three Bitsy games made. 


Among other things: 


candle’s World of Bitsy 
< candle.itch.io/world-of-bitsy > 


zeroday’s Bitsy Guide 
< zeroday.camp/wp-content/uploads/2018/09/ 
Bitsy-Guides.pdf > 


Bitsy Handout 
< rahji.github.io/bitsy-handout/web/ > 


Tools tagged with ‘Bitsy’ 
< itch.io/tools/tag-bitsy > 


Dan Cox’s Bitsy tutorials 
< www. youtube. com/playlist?list=PLlLXuD3kyVEr5s 
FAiM2CszNt-fSVZDqxUm > 
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